package com.huahai.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.huahai.common.DeleteRequest;
import com.huahai.pojo.dto.space.SpaceAddDTO;
import com.huahai.pojo.dto.space.SpaceQueryDTO;
import com.huahai.pojo.entity.Space;
import com.huahai.pojo.entity.User;
import com.huahai.pojo.vo.space.SpaceVO;

import javax.servlet.http.HttpServletRequest;

/**
* @author huahai
* @description 针对表【space(空间)】的数据库操作Service
* @createDate 2025-07-29 13:34:19
*/
public interface SpaceService extends IService<Space> {

    /**
     * 创建个人私有空间
     * @param spaceAddDTO 创建空间参数
     * @param loginUser 登录用户
     * @return 创建的空间id
     */
    Long addSpace(SpaceAddDTO spaceAddDTO, User loginUser);

    /**
     * 删除空间
     * @param deleteRequest 删除参数
     * @param loginUser 登录用户
     * @return 删除结果
     */
    Boolean deleteSpace(DeleteRequest deleteRequest,User loginUser);

    /**
     * space类型转换脱敏（单个空间）
     * @param space 空间对象
     * @param request 请求
     * @return SpaceVO
     */
    SpaceVO getSpaceVO(Space space, HttpServletRequest request);

    /**
     * 分页获取空间封装
     * @param spacePage 分页参数
     * @param request 请求
     * @return Page<SpaceVO> 分页后的脱敏空间列表
     */
    Page<SpaceVO> getSpaceVOPage(Page<Space> spacePage, HttpServletRequest request);

    /**
     * 封装空间查询条件QueryWrapper
     * @param spaceQueryDTO 空间查询条件
     * @return QueryWrapper<Space>
     */
    QueryWrapper<Space> getQueryWrapper(SpaceQueryDTO spaceQueryDTO);

    /**
     * 空间基本校验
     * @param space 空间对象
     */
    void validSpace(Space space,Boolean add);

    /**
     * 填充空间等级
     * @param space 空间对象
     */
    void fillSpaceLevel(Space space);

    /**
     * 校验空间权限
     * @param space 空间对象
     * @param loginUser 登录用户
     */
    void checkSpaceAuth(Space space, User loginUser);
}
